home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat2 / standard / setpgid.z / setpgid
Text File  |  1998-10-20  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssseeeettttppppggggiiiidddd((((2222))))                                                          sssseeeettttppppggggiiiidddd((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_eeee_tttt_pppp_gggg_iiii_dddd - set process group ID
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  14.  
  15.      _iiii_nnnn_tttt _ssss_eeee_tttt_pppp_gggg_iiii_dddd_((((_pppp_iiii_dddd______tttt _pppp_iiii_dddd_,,,, _pppp_iiii_dddd______tttt _pppp_gggg_iiii_dddd_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _ssss_eeee_tttt_pppp_gggg_iiii_dddd sets the process group ID of the process with ID _p_i_d to _p_g_i_d.  If
  19.      _p_g_i_d is equal to _p_i_d,  the process becomes a process group leader.  If
  20.      _p_g_i_d is not equal to _p_i_d, the process becomes a member of an existing
  21.      process group.
  22.  
  23.      If _p_i_d is equal to 0, the process ID of the calling process is used.  If
  24.      _p_g_i_d is equal to 0, the process specified by _p_i_d becomes a process group
  25.      leader.
  26.  
  27.      _ssss_eeee_tttt_pppp_gggg_iiii_dddd fails and returns an error if one or more of the following are
  28.      true:
  29.  
  30.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS         _p_i_d matches the process ID of a child process of the
  31.                     calling process and the child process has successfully
  32.                     executed an _eeee_xxxx_eeee_cccc(2) function.
  33.  
  34.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         _p_g_i_d is not a valid process group id value.
  35.  
  36.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The calling process has a controlling terminal that does
  37.                     not support job control.
  38.  
  39.      _EEEE_PPPP_EEEE_RRRR_MMMM          The process indicated by the _p_i_d argument is a session
  40.                     leader.
  41.  
  42.      _EEEE_PPPP_EEEE_RRRR_MMMM          _p_i_d matches the process ID of a child process of the
  43.                     calling process and the child process is not in the same
  44.                     session as the calling process.
  45.  
  46.      _EEEE_PPPP_EEEE_RRRR_MMMM          _p_g_i_d does not match the process ID of the process
  47.                     indicated by the _p_i_d argument and there is no process with
  48.                     a process group ID that matches _p_g_i_d in the same session
  49.                     as the calling process.
  50.  
  51.      _EEEE_SSSS_RRRR_CCCC_HHHH          _p_i_d does not match the process ID of the calling process
  52.                     or of a child process of the calling process.
  53.  
  54. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.      _eeee_xxxx_eeee_cccc(2), _eeee_xxxx_iiii_tttt(2), _ffff_oooo_rrrr_kkkk(2), _gggg_eeee_tttt_pppp_iiii_dddd(2), _gggg_eeee_tttt_pppp_gggg_iiii_dddd(2), _ssss_eeee_tttt_ssss_iiii_dddd(2),
  56.      _tttt_cccc_ssss_eeee_tttt_pppp_gggg_rrrr_pppp(3T).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssseeeettttppppggggiiiidddd((((2222))))                                                          sssseeeettttppppggggiiiidddd((((2222))))
  71.  
  72.  
  73.  
  74. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  75.      Upon successful completion, _ssss_eeee_tttt_pppp_gggg_iiii_dddd returns a value of 0.  Otherwise, a
  76.      value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.